package com.guomei.mapper.curse;

import com.guomei.bean.curse.UserCourseLearn;
import com.guomei.bean.curse.vo.CourseLearnStat;
import com.guomei.bean.curse.vo.CourseLearnStatDto;

import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 用户课程学习记录Mapper接口
 */
@Mapper
public interface UserCourseLearnMapper {
    /**
     * 根据ID查询
     * @param id 主键
     * @return 用户课程学习记录
     */
    UserCourseLearn selectById(Long id);

    /**
     * 根据用户ID和视频ID查询
     * @param userId 用户ID
     * @param videoId 视频ID
     * @return 用户课程学习记录
     */
    UserCourseLearn selectByUserAndVideo(@Param("userId") Long userId, @Param("videoId") Long videoId);

    /**
     * 根据用户ID和课程ID查询列表
     * @param userId 用户ID
     * @param courseId 课程ID
     * @return 学习记录列表
     */
    List<UserCourseLearn> selectByUserAndCourse(@Param("userId") Long userId, @Param("courseId") Long courseId);

    /**
     * 新增记录
     * @param userCourseLearn 学习记录
     * @return 影响行数
     */
    int insert(UserCourseLearn userCourseLearn);

    /**
     * 更新记录
     * @param userCourseLearn 学习记录
     * @return 影响行数
     */
    int update(UserCourseLearn userCourseLearn);

    /**
     * 根据ID删除
     * @param id 主键
     * @return 影响行数
     */
    int deleteById(Long id);
    /**
     * 根据条件查询用户学习记录
     * @param userCourseLearn 查询条件
     * @return 用户学习记录列表
     */
    List<UserCourseLearn> selectByCondition(UserCourseLearn userCourseLearn);

    /**
     * 根据用户ID获取用户学习的课程ID列表
     * @param userId 用户ID
     * @return 课程ID列表
     */
    List<Long> selectCourseIdsByUserId(@Param("userId") Long userId);
    
    /**
     * 统计用户开始学习的课程数量
     * @param userId 用户ID
     * @return 开始学习的课程数量
     */
    Long countStartedCoursesByUserId(@Param("userId") Long userId);
    
    /**
     * 统计用户进度为100%的记录数量（已完成的视频数量）
     * @param userId 用户ID
     * @return 已完成的视频数量
     */
    Long countCompletedVideosByUserId(@Param("userId") Long userId);
    
    /**
     * 统计用户总学习时长（秒）
     * @param userId 用户ID
     * @return 总学习时长（秒）
     */
    Long sumLearnDurationByUserId(@Param("userId") Long userId);

    /**
     * 根据课程IDs和用户id查询学习记录
     * @param courseIds 课程IDs
     * @param userId 用户id
     * @return 学习记录列表
     */
    List<UserCourseLearn> selectByVideoIdsAndUserId(@Param("videoIds") List<Long> videoIds, @Param("userId") Long userId);

    /**
     * 根据用户id查询学习记录（支持分页）
     * @param dto 查询参数（包含userId、pageNum、pageSize）
     * @return 学习记录列表
     */
    List<CourseLearnStat> selectByVideoIds(CourseLearnStatDto dto);
    
    /**
     * 统计用户已学完的课程数量
     * 判断标准：课程下的所有视频进度都是100%
     * @param userId 用户ID
     * @return 已学完的课程数量
     */
    Long countFinishedCoursesByUserId(@Param("userId") Long userId);
}
